wiki

Foire aux Questions sur l'utilisation du wiki

Le but de cette page est de donner les réponses aux interrogations les plus fréquentes des utilisateurs du wiki.

Utilisation de dokuwiki :

Comment faire pour réaliser une modification mineure dans une section ?
Comment procéder pour modifier plusieurs sections d'une même page ?
Pour modifier une page en profondeur, par où commencer ?
Comme renommer une page et/ou la changer d'emplacement ?

Régulation de la documentation :

Comment s'effectue la régulation du wiki?
Que faire en cas de vandalisme ?

Utilisation de dokuwiki

Réaliser une modification mineure

Rendez-vous sur la page à modifier. Cherchez et cliquez sur le bouton « Éditer » juste en dessous la section à modifier.
Modifiez le texte dans l'éditeur de dokuwiki.
Ajoutez un résumé pour décrire votre contribution.
Cliquez sur le bouton « Aperçu ».
Si cela vous conviens, cliquez sur « Enregistrer », sinon, modifiez à nouveau le texte, et redemandez un aperçu.

Un brouillon est créé à chaque clic sur le bouton « Aperçu ». En cas de perte de connexion, vous pourrez repartir de ce brouillon à la prochaine édition.

Modifier plusieurs sections d'une même page

Tout d'abord, il est recommandé de lire les explications sur la syntaxe propre à dokuwiki.
Si ce n'est pas déjà fait, nous recommandons aux contributeurs de s'authentifier sur le wiki. Pour cela, il faut s'inscrire sur le forum.
Ensuite, rendez-vous sur la page à modifier, et cliquez sur le bouton « Éditer cette page » dans la colonne de gauche.
Vous pouvez maintenant modifier l'ensemble du contenu de la page en une seule fois.
La suite est la même que pour une modification mineure.
Une fois la page enregistrée, envoyez un mail pour décrire votre signaler votre contribution à la liste de discussion des contributeurs du wiki.

Modifier une page en profondeur

Tout d'abord il est préférable de présenter les remaniements que souhaitez entreprendre sur la liste de discussion des contributeurs du wiki.
Vous pouvez également contacter les premiers auteurs ainsi que les précédents contributeurs.

Si vous avez l'approbation des différents contributeurs de la documentation et/ou des administrateurs du wiki, vous pouvez réaliser les modifications souhaitées.
Si aucun consensus ne se dégage des discussions sur la liste, vous pouvez créer votre version de la page dans votre espace personnel (page "brouillon" ou "bacasable").
Une fois la nouvelle version rédigée, soumettez-là à l'approbation de la liste de discussion. Il est souvent plus facile de juger sur pièce.

Déplacer/renommer une page

Lorsque vous travaillez sur de long projet, il est préférable de créer des pages brouillon dans son espace utilisateur. Une fois la page terminée, et validée par la communauté, il faut la renommer et la placer à l'endroit adéquat : c'est à dire à la racine ou dans le dossier tutoriel.

Certaines pages existantes sont également mal placées ou mal nommées.

Il est conseillé d'utiliser plusieurs fenêtres ou plusieurs onglets côte à côte pour plus de facilité.

Se rendre sur la page à l'url initiale ;
- Éditer l'ensemble de la page ;
- Sélectionner et copier la totalité du texte dans l'éditeur (raccourci clavier CTRL+A puis Copier) ;
Se rendre sur la nouvelle url ;
- Cliquer sur "Créer cette page" dans la colonne de gauche ;
- Coller le texte de l'ancienne page dans l'éditeur ;
- Enregistrer la page en indiquant en commentaire son url d'origine ;
Retourner à l'ancienne url
- Cliquer sur "Lien vers cette page" (backlinks)
- Pour chacune des pages listées, il faut :
  - Éditer la page ;
  - Remplacer l'ancienne url par le nouvel emplacement de la page déplacée ;
  - Enregistrer la modification avec un commentaire explicite (de préférence le même pour toutes les pages impactées)
Lorsqu'il n'y a plus de page pointant sur l'ancienne url, cliquer à nouveau sur "Editer cette page" ;
- Sélectionner tout le texte dans l'éditeur, et le supprimer ;
- Enregistrer la page en indiquant en commentaire la nouvelle url ;
- Le message « Cette page n'existe pas encore » doit apparaît, signe que l'ancienne page n'existe plus.

On pourrait être tenté de créer une redirection de l'ancienne page vers le nouvel emplacement. Cependant, cela pose différent problème comme la difficulté de lister l'ensemble des pages pointant sur le nouvel emplacement. Cela complique également l'administration de dokuwiki.
Par conséquent, il est recommandé de ne pas utiliser de redirection sur la documentation.

Régulation de la documentation

Modération

Les contributions doivent-elles être approuvées pour apparaître sur le wiki ?
⇒ Non, toute modification d'une page est directement visible par les visiteurs dès que l'auteur a sauvegardé la page.

Comment/Qui s'assure qu'il n'y a pas de débordement ?
⇒ Les différents contributeurs du wiki vérifient régulièrement les modifications récentes apportée à la documentation.
⇒ Certains contributeurs sont également abonné à la page ou à la catégorie, ce qui leur permet d'être notifié par mail des changements apportés.
⇒ Enfin, l'équipe d'administration vérifie l'ensemble des notifications de changement envoyés automatiquement par dokuwiki sur un compte mail partagé.

C'est pourquoi il ne faut pas faire d'enregistrement "à la chaine" à chaques petites modifications. Préférez l'édition de la page entière, et un seul enregistrement lorsque toutes les retouches ont été faites.

Que faire en cas de vandalisme ?

Si vous observez qu'une page a été vandalisée, il y a 2 actions à réaliser :

Restaurer la version précédente de la page :
- depuis la page vandalisée, dans la colonne de gauche, cliquez sur « anciennes révisions ».
- cliquez sur le second lien dans la liste à puce.
- la version précédente de la page s'affiche, avec en entête le message « Ceci est une ancienne révision du document ! ».
- dans la colonne de gauche, cliquez sur « Restaurer ».
Alerter par mail la liste de discussion des contributeurs du wiki.

Contributeurs : draco31.fr Le 07/01/2011, 16:45